Skip to content

docs: consolidate Codex, Grok, and OpenCode runtime status - #443

Closed
vansin wants to merge 2 commits into
mainfrom
agent/runtime-integrations-docs
Closed

docs: consolidate Codex, Grok, and OpenCode runtime status#443
vansin wants to merge 2 commits into
mainfrom
agent/runtime-integrations-docs

Conversation

@vansin

@vansin vansin commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

What

  • add one evidence-scoped status page for Codex, Grok, and OpenCode runtime integrations
  • separate the shipped Codex Phase-0 preview from the unmerged RFC-030 Policy Gateway production candidate
  • correct the Codex 0.144.0 WebSocket Upgrade path to / and mark the RFC-030: wire codex-app-server into anet CLI #441 CLI command as a draft-branch candidate, not a published guarantee
  • distinguish the automatic opencode-cli ACP runtime from MCP-only human-driven access
  • record the three current OpenCode onboarding gaps: TTY picker/explicit runtime, model propagation, and per-node HOME wiring
  • preserve the Grok Round-5 partial verdict and all remaining Phase-1A gates

Why

The existing runtime evidence lives across RFCs, issues, draft PRs, fixtures, and research reports. This page consolidates it without promoting a fixture, source path, or internal freeze into a release claim.

Impact

Docs only. This PR does not unlock RFC-030 §8, Wave 2, merge, deployment, production, package promotion, or latest. It also does not unlock Grok Phase 1A or claim that OpenCode CLI onboarding is complete.

Checks

  • git diff --cached --check
  • relative evidence links verified against origin/main
  • npm preview versions verified with npm view
  • public-safety scan: no token prefixes, credential literals, host paths, internal hostnames, or memory slugs
  • Codex and OpenCode sections independently source-checked; Grok section remains Draft pending runtime-owner final review

@vansin

vansin commented Jul 29, 2026

Copy link
Copy Markdown
Contributor Author

分诊(2026-07-29,通信龙):建议保留,小幅更新后可合。

内容质量高,尤其是这几点符合我们的既有标准:

  • 只描述有证据支持的能力
  • 未过独立审查的一律标「审查中」或「锁定」
  • 明确声明本文不授权 latest / 生产发布 / 安全门豁免

今天早上 Vincent 直接问过「opencode 做得怎么样了」「codex TUI 共存进 npm 了吗」—— 本文正是答案。它躺在草稿里没人合,导致这个问题被重新查了一遍。

需要更新的(版本号漂移):文中引用 agent-node@2.5.0-preview.20agent-network@2.3.0-preview.22,当前 npm 分别是 2.5.0-preview.27 / 2.3.0-preview.35

补充今天的实测供更新参考:

  • copresenceopencode 在 npm latest 通道命中数均为 0,仅存在于 preview
  • --copresence隐藏参数,不出现在 --help,只看帮助会误判为不存在
  • anet node create 的 runtime picker 在 latest 上确实显示 4 项(含 claude-code-cli

状态 MERGEABLE / CLEAN,无冲突。

@vansin

vansin commented Aug 12, 2026

Copy link
Copy Markdown
Contributor Author

分流结论:面向用户的那份已经落地在更好的位置,建议关闭。

本 PR 想加 docs/runtime-integrations.md(仓内文档,未进 main)。
但 main 上已有公开文档站的版本,中英双语:

docs-site/docs/guide/runtimes.md
docs-site/docs/en/guide/runtimes.md
覆盖:Claude / Codex / Grok / OpenCode

它已经在 anet.sh 上线,读者能直接看到;仓内再放一份等价内容会形成两个真相源,
而这类「运行时状态」文档一旦分叉,过时的那份不会有人发现(今天刚在 REST API 文档上踩过同类问题,见 #737)。

如果本 PR 里有 runtimes.md 没覆盖的信息(尤其你正文提到的
「把已发布的 Codex Phase-0 preview 与未合并的 RFC-030 Policy Gateway 分开」这一点),
建议把那部分补进 docs-site/docs/guide/runtimes.md,而不是新开一份。

按「不能确立就不关」原则,我没关 —— 我无法替你判断那部分差异是否重要。

@vansin

vansin commented Aug 12, 2026

Copy link
Copy Markdown
Contributor Author

Closing as an obsolete status snapshot; preserving the branch and commit history.

This draft is dated 2026-07-13 and makes time-sensitive current-state claims that are contradicted by present origin/main, for example:

  • it describes codex-app-server CLI wiring as an unmerged RFC-030: wire codex-app-server into anet CLI #441 candidate, while current main contains the create picker, explicit runtime handling, help text, start/coprocess paths, and runtime implementation;
  • it describes grok-build-cli as source-only/not exposed, while current main contains its picker, create/start/upgrade compatibility paths and published-runtime checks;
  • its package coordinates stop at agent-node 2.5.0-preview.20 and agent-network 2.3.0-preview.22; current main declares 2.5.0-preview.31 and 2.3.0-preview.39.

Because this file presents itself as a consolidated current status page rather than an immutable dated test report, merging it now would reintroduce known-false operational guidance. Any useful historical evidence remains reachable in PR #443/commit 719576b5aee5e9765e510c2a450a5819e4f3d4cd; a future status page must be regenerated from current main and current release evidence rather than rebasing this snapshot.

No branch deletion, force-push, code change, package release, deployment, or production action was performed.

@vansin vansin closed this Aug 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants